From 58920cebf5f4cb76ad5440252dad41a9c11f03f7 Mon Sep 17 00:00:00 2001
From: oliskoli <oliskoli@f51c46e8-681c-474f-0cfe-069cfd0219fb>
Date: Thu, 31 Jul 2008 20:01:20 +0000
Subject: [PATCH] Add doc for unicsv options 'Filename' and 'Format'.

---
 .../formats/options/unicsv-filename.xml       | 25 +++++++++++++++++++
 .../xmldoc/formats/options/unicsv-format.xml  | 22 ++++++++++++++++
 2 files changed, 47 insertions(+)
 create mode 100644 gpsbabel/xmldoc/formats/options/unicsv-filename.xml
 create mode 100644 gpsbabel/xmldoc/formats/options/unicsv-format.xml

diff --git a/gpsbabel/xmldoc/formats/options/unicsv-filename.xml b/gpsbabel/xmldoc/formats/options/unicsv-filename.xml
new file mode 100644
index 000000000..6498beb07
--- /dev/null
+++ b/gpsbabel/xmldoc/formats/options/unicsv-filename.xml
@@ -0,0 +1,25 @@
+<para>
+  When this option is enabled, we write an additional column called 'Filename'.
+  The values of this column are filled with filenames of previos input formats.
+</para>
+<para>
+  This can be very helpful for locating specific waypoints (i.e. using the position filter)
+  in more than one file.
+</para>
+<example id="unicsv_filename">
+  <title>Example for unicsv filename option to write filenames of input formats.</title>
+  <para>
+    The next example ...
+    <userinput>
+      gpsbabel -i gpx -f file1.gpx -i gdb -f file2.gdb -o unicsv,filename=1 -F result.txt
+    </userinput>
+    ... could produce following output:
+    <simplelist type="vert">
+      <member>No,Latitude,Longitude,Name,Date,Time,Filename</member>
+      <member>1,51.075139,12.463689,"578",2005/04/26,16:27:23,"reference/gdb-sample.gdb"</member>
+      <member>2,51.081104,12.465277,"579",2005/04/26,16:27:23,"reference/gdb-sample.gdb"</member>
+      <member>3,50.844126,12.408757,"580",2005/02/26,10:10:47,"reference/gdb-sample.gpx"</member>
+      <member>4,50.654763,12.204957,"581",2005/02/26,09:57:04,"reference/gdb-sample.gpx"</member>
+    </simplelist>
+  </para>
+</example>
diff --git a/gpsbabel/xmldoc/formats/options/unicsv-format.xml b/gpsbabel/xmldoc/formats/options/unicsv-format.xml
new file mode 100644
index 000000000..6374311e3
--- /dev/null
+++ b/gpsbabel/xmldoc/formats/options/unicsv-format.xml
@@ -0,0 +1,22 @@
+<para>
+  When this option is enabled, we generate an additional 'Format' column.
+  The values of this column are filled with names of previos input formats.
+</para>
+<example id="unicsv_format">
+  <title>Example for unicsv format option to write names of input formats.</title>
+  <para>
+    The next example ...
+    <userinput>
+      gpsbabel -i gpx -f file1.gpx -i gdb -f file2.gdb -o unicsv,format=y -F result.txt
+    </userinput>
+    ... could produce following output:
+    <simplelist type="vert">
+      <member>No,Latitude,Longitude,Name,Description,Symbol,Date,Time,Format</member>
+      <member>1,51.075139,12.463689,"578","578","Waypoint",2005/04/26,16:27:23,"gdb"</member>
+      <member>2,51.081104,12.465277,"579","579","Waypoint",2005/04/26,16:27:23,"gdb"</member>
+      <member>3,50.844126,12.408757,"Gosel","Gosel","Exit",2005/02/26,10:10:47,"gpx"</member>
+      <member>4,50.654763,12.204957,"Greiz",,"Exit",2005/02/26,09:57:04,"gpx"</member>
+    </simplelist>
+  </para>
+</example>
+
-- 
2.30.2